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Overview 





LiveCode 9.0 enables access to libraries and platform APIs written in many other languages 
thanks to the community-funded ‘Infinite LiveCode' project. 


This includes a greatly improved LiveCode Builder virtual machine. 


LiveCode 9.0 contains many additional improvements to support LiveCode app developers, 


including: 


e Anew "spinner" widget 
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e OAuth2 authentication library for use with web APIs (e.g. Facebook, Google and GitHub) 
e Acommand argument parser library for building command-line standalones 


e Updates and performance improvements for existing widgets 
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e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording. 
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Boolean constants 


In this release, boolean constants true and false have been changed so that they resolve to 


values of boolean type (rather than string). This will affect any uses of the 1S strictly operator 
on such values, i.e. previously the following were true: 


true is Strictly a string false is strictly a string 
Now, they are both false, and the following are true: 
true is strictly a boolean false is strictly a boolean 


Boolean constants passed as elements of arrays to LCB handlers will not require conversion to 
boolean values in LCB - in fact any attempt to do so assuming they are strings will cause an error. 
Any array elements which are intended to be booleans in LCB should be checked for their type 
before conversion. For example, any of the following could be done by an LCB library user: 


put true into tArray["enabled" ] 
put "true" into tArray["enabled" ] 
DUEL VaherS Gt. Chabled=)e into slat ray |.chapled | 


An LCB handler to which tArray is passed should do the following: 
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variable tEnabled as Boolean 
if tArray["enabled"] is a boolean then 
put tAction["enabled"] into tEnabled 
else 
put tAction["enabled"] parsed as boolean into tEnabled 
end if 


Infinity constant 


The constant infinity has been added to the language in this release. As a result, the 
unquoted literal infinity is nowreserved. Any existing uses of it should be quoted, as otherwise 
it will resolve to the floating point value representing infinity, rather than the string "infinity". 


Implicit object 


A number of LCB commands use an implicit object to provide context for their execution. Some of 
these commands also allow specifying an explicit object. These commands are: 


e execute script 

e send 

e post 

e image from file 

e resolve file - newin this version 


In previous releases execute script and image from file would use 

this card of the defaultStack as the implicit object even if called from a widget. The send 
and post commands, however, used this card of the defaultStack when in a library 
module handler and the host widget when in a widget module handler. This release changes 
execute script and image from file to also use the host widget as the implicit object. This 
means, for example, that image from file will resolve a relative file path relative to the 
StackFile the host widget is on rather than the stackFile of the defaultStack. 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 


LiveCode supports the following versions of Windows: 
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e Windows 7 (both 32-bit and 64-bit) 
e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [Server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


o0 GTK/GDK 2.24 or later 

o Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

°o Icms (optional, required for color profile Support in images) 
°o gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 


The Mac engine supports: 


e 10.9.x (Mavericks) 
e 10.10.x (Yosemite) 
e 10.11.x (El Capitan) 
e 10.12.x (Sierra) 

e 10.13.x (High Sierra) 
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e 10.14.x (Mojave) 
e 10.15.x (Catalina) 


iOS 
IOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 8.2 on MacOS X 10.11 

e Xcode 9.2 on MacOS 10.12 (Note: You need to upgrade to 10.12.6) 
e Xcode 10.1 on MacOS 10.13 (Note: You need to upgrade to 10.13.4) 
e Xcode 11.3 on MacOS 10.14 (Note: You need to upgrade to 10.14.4) 
e Xcode 11.4 on MacOS 10.15 (Note: You need to upgrade to 10.15.2) 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on MacOS 10.12 (Sierra), you can add Xcode 8.2 in the Mobile Support 
preferences, to let you test your stack on the i/OS Simulator 10.2. 


We currently support building against the following versions of the iOS SDK: 


e 10.2 (included in Xcode 8.2) 
e 11.2 (included in Xcode 9.2) 
e 12.1 (included in Xcode 10.1) 
e 13.2 (included in Xcode 11.3) 
e 13.4 (included in Xcode 11.4) 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using x86, x86-64, ARM and ARM64 processors. It will run on 
the following versions of Android: 


e 5.0-5.1 (Lollipop) 
e 6.0 (Marshmallow) 
e 7.x (Nougat) 

e 8.x (Oreo) 

e 9.0 (Pie) 

e 10.0 (Q) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
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"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTMLS5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Setup 





Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS xX, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

Windows _aanaaeeene el data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 
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Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS xX, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install -ui [OPTION ...] 
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where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 
-allusers 
for the current user only. 
seal ceapatweeenr Place a shortcut on the Desktop (Windows-only) 
-startmenu Place shortcuts in the Start Menu (Windows-only) 
-Location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 
Slap oie ae The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <installer> install -ui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall -ui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 
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Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 


given SECRET passphrase, and installs a license file for all users of the computer. Manual 
activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <livecode> activate -file LICENSE -passphrase SECRET 
Start /wait <livecode> deactivate 


On Mac OS xX, you need to do: 


<Livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<Livecode>/Contents/MacOS/LiveCode deactivate 
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Dark mode detection 


A new systemAppearance property has been added which returns dark if the application is 
running in dark mode and light otherwise. 
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A new systemAppearanceChanged message is nowsent to the current card of the defaultStack 
when the system appearance changes. 


Update Android text rendering 


This update resolves issues with incorrect spacing between characters when drawing text on 
Android. 


A new output kind detailed-utf8 has been added to the 
files and folders functions 


The { long | detailed } { files | folders } of <folder>, 
files(<folder>, "detailed"), and folders(<folder>, "detailed") suffer from an 


anomaly bug where file and folder names are native encoded before being URL encoded to add to 
the list. The native encoding is can not represent many unicode codepoints and is therefore lossy. 


The new detailed-utf8 output kind encodes file and folder names as utf8 before URL encoding 
them. This allows the names to be decoded via textDecode(URLDecode(<name>), “utf8"). 


Fix iOS mobile browser controls not resizing after setting 
certain properties. 


Setting the mobile browser control 'dataDetectorTypes'’, ‘allowsInlineMediaPlayback', and 
‘mediaPlaybackRequiresUserAction' properties will no longer prevent the underlying view from 
resizing to fit the configured rect of the browser control. 


IOS mobile player control updated to use AVKit 


The existing implementation of the mobile player control for iOS has been replaced with one 
based on the AVKit framework. 


While every attempt has been made to ensure full compatibility with the previous implementation, 
differences between the frameworks used means that some features may not function as before 
or may no longer be available. These are listed below: 


e mobileControlDo actions: "begin seeking forward" - unsupported "begin seeking 
backward" - unsupported ** "end seeking" - unsupported 


e mobileControlSet properties: "useApplicationAudioSession" - unsupported 
“allowsAirPlay" - now covers all external playback 


e mobileControlGet properties: ** "playbackState" - values "seeking forward" and "seeking 
backward" unsupported 


e Messages: "playerEnterFullscreen" - enter fullscreen via user action not 
detected "playerLeaveFullscreen" - leave fullscreen via user action not detected ** 
"playerMovieChanged" - unsupported 
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Mobile browser control iOS update. 


The mobile browser control has been updated to use the WebKit framework on iOS. This provides 
better performance on iOS devices. 


Print to PDF on Android 


The open printing to pdf ... 
file on Android devices. 


command can now be used to direct printing to a PDF output 


Specific engine bug fixes (9.6.0-rc-2) 


22729 
22733 
22737 


iOS frameworks are no longer signed with the app entitlements 
Remove redundant warning from the standalone builder 
Make sure the externals Icextd folder is not copied into the apk 


Specific engine bug fixes (9.6.0-rc-1) 


11554 
19848 
21305 
22209 


22363 
22433 
22605 


22663 


22684 
22686 


22702 
22718 


Removed inaccurate information about mobilePickDate on Android 

Clarified in the docs how objects can still move when lockLocation is true 
Improve performance of stackfile saving on Windows 

Update copyright notice 

Windows Player now shows the correct video frame when the currentTime is changed 
while playback is paused. 

Clarified that selectionChanged is not sent when the text changes 

iOS standalones now use a storyboard based splash with a centered image and 
background color 

Add support for max width and max height parameters to mobilePickPhoto on 
Android 

Ensure mobileSensorReading("location",false) returns a non-empty list 
Corrected example in playerPropertyAvailable 

Add ad-hoc signature to mac standalones, to allow mac apps to be opened on 
MacOS Catalina 


Fix error when accepting connections to a socket on some older Android devices 


Specific engine bug fixes (9.6.0-dp-4) 


21566 
22054 


22487 


22596 
22606 
22607 


Fix crash when opening and closing modal windows under some circumstances 
Ensure mobilePickPhoto() proceeds after taking a photo on Samsung phones 


mobilePick, mobilePickDate and ask dialog on iOS now use the correct colors in dark 
mode. 


Included Android as supported in the playLoudness dictionary entry 
Add support for opting out of iOS dark mode 
Dark mode detection 
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22635 


22645 
22664 


22671 
22673 
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Ensure mobilePick and mobilePickDate menus scale correctly on landscape 
orientation 

Removed unsupported minimum deployment versions from the Android standalone 
settings 

Add NSBluetoothAlwaysUsageDescription to iOS plist template 

Support mobilePickPhoto "front camera" on Android 

Ensure Android mobile player controller is not visible when the control is not visible 
Show first frame in Android mobile player after loading file 


Specific engine bug fixes (9.6.0-dp-3) 


7948 

16240 
17361 
18876 
19997 
22295 
22508 
22511 
22530 
22533 


22536 
22552 
22556 
22577 
22591 


22602 
22612 
22614 


22615 


22616 


Added note that revDeleteFolder can not delete the defaultFolder 
Explained the non-recursive behaviour of the replace command in its entry. 
Ensure mobileControlDo "“myinput", "focus" works on Android 

Fix text duplication when deleting text previously entered into a field on Android 
Ensure "the printPaperRectangle" returns the correct value 

Added support for splash screens and icon for iPad Pro 11 

Fix clipboard contents being cleared when setting dragdata on Windows 

Fix multi-codepoint character parsing in JSONImport() 

Update Android text rendering 

Add support for the layerClipRect property to widgets 

The replace command will no longer fail incorrectly in some cases where there are no 
possible replacements to be made 

Fix crash touching screen during preOpenStack on Android 

Drag and drop on macOS from LiveCode to another application no longer fails after 
three drags 

Ensure the device token in push notifications is returned correctly 

Ensure drag-n-drop of a filename with spaces onto Mail app adds the file as an 
attachment 

Ensure setting the keyboardType has an effect on iOS even if the returnKeyType is 
not set 

Allow detection of "Apple Distribution" certificates 

Ensure focused control is correct when opacity of control under mouse pointer 
changes 

Fix error when building an Android standalone if the Barcode Scanner widget is 
included 

Fixed browser widget within a group on Android appearing in an incorrect position 
after moving the group 


Specific engine bug fixes (9.6.0-dp-2) 


22190 


22213 


Ensure setting the spaceAbove does not change the existing value of soaceBelow 
property 

A new output kind detailed-utf8 has been added to the files and folders 
functions 
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Fix page not displayed after setting htmltext of browser widget 

Ensure text sort of mixed ASCIl/Unicode lines of a variable works correctly 

Add support for merging activity attributes in Android Manifest Merging mechanism 
Fix tabAlign property not saving when tabStops is not set 

Prevent crash when calling binarayDecode with wrong data input 

Fix iOS mobile browser controls not resizing after setting certain properties. 

Fix listing the executing object's stack rather than the object in the 
executionContexts for password protected stacks 


Specific engine bug fixes (9.6.0-dp-1) 


22278 
22346 


22302 


22414 
22463 


Corrected missing text issue in the documentation for the log command 

Fix crash when an error occurs in a SQLite query 

Fix incorrect stack size on Android for fullscreen mode showALl when the device has 
a soft button bar 

Fix crash on Android coalescing window reshape events 

Fix compilation of ellipse elements in drawing svg compiler 


EWV{=1 fore [=m Oro) palaaleialia’ aD) =elal-lalelss 





Specific IDE bug fixes (9.6.0-rc-2) 


22285 Only reselect key field in customprops editor in response to a change in hilite 


Specific IDE bug fixes (9.6.0-dp-4) 


22627 
22655 


Fix wandering breakpoints in when deleting lines 
Ensure upload of a .livecode stack is possible in revOnline 


Specific IDE bug fixes (9.6.0-dp-2) 


22092 
22137 
22145 
22477 
22486 


Sync auto complete field when msg box is scrolled horizontally 

Fix issue Causing conditional breakpoints in repeat loops to only be evaluated once 
Add missing variable declaration to editorcommon 

Fix broken links in Resource Center 

Fix missing return in commoneditor scriptFormat 


Specific IDE bug fixes (9.6.0-dp-1) 
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16933 Adapt icon size to text size in Project Browser 

Split non-synonymous DataGrid commands deletelndex and deletelndexes as well as 
deleteLine and deleteLines in the documentation. 

22440 _ Fix card indentation in PB if stack name contains "of" 

22443 Align wdget "icon" with connectors in Project Browser 


21576 
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Navigation Bar widget 

No Highlight Option 

Add an option to have none of the navigation items highlighted. 
Properties 


e The hilightedIitem property has been enhanced to accept a value of 0 which indicates that 
no items will be highlighted. 


Backward Compatibility Note 


e Ifa stack is saved without an item being highlighted, then when opened in an earlier version 
of the widget, a callto getNavSelectedItemName will throw an error if called before an 
item is selected. 


e The widget will render properly (with nothing highlighted) and issue the hiliteChanged 
message when an item Is selected. 


SVG Icon widget 


Implementation 


The svgpath widget will now only perform costly scaledWidth and scaledHeight recalculations when 
the widget with or height changes. 


Browser widget 


Browser widget iOS update. 


The browser widget has been updated to use the WebKit framework on iOS. This provides better 
performance on iOS devices. 


In addition, the update enables the browser widget 'userAgent' property on iOS. 
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Tree View widget 


Properties 
Enhance the Tree View Widget to support use on the mobile platform. 


e Adjust row height when font name or size changes 
e Trimming improvements 


o When font name or size changes, re-evaluate ellipsis width to properly trim contents 
of keys/values 

In readOnly mode, only save space for a single icon on the right 

o Prevent last character from being turned into an ellipsis 

o Width was being reported with extra space for an ellipsis when not needed 

o Remove padding from ellipsis width, only add padding when needed 


fe) 


e Save alternate row backgrounds property 
e Save show border property 


New properties: 


e charsToTrimFromKey - allowa sorting value to be added to the front of the key that is 
trimmed for display 

e hilitedElementIsFolded - adjust the fold state of the selected element 

e formattedHeight - content height for scroller support 

e scroll and vScroll - scroll position 

e textHeight - custom row height 

e vScrollBar - control visibility of scroll bar 

e showHover - allowhover to be disabled, useful on mobile 

e iconHeight - allow configuration of icon size 

e showVaLlues - allowthe values to be hidden 


Signals 


e formattedHeightChanged - message to report content height change to support 
scrollers 


Android Utilities module 


Registering for lifecycle SensorEventListener 


A new handler AndroidRegisterLifecycleListener has been added that allows for widgets to 


track application lifecycle events, specifying handlers to be called when the application is paused 
or resumed. The first parameter is the handler to be called when the application is paused. The 
second parameter is the handler to be called when the application is resumed. 


The listener object returned by AndroidRegisterLifecycleListener can be unregistered by 
calling AndroidUnregisterLifecycleListener, meaning the pause and resume handlers will 
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no longer be called. 


Specific extension bug fixes (9.6.0-rc-1) 


22624 Do not register click when scrolling (mobileScroller) 

Fix bug preventing mobile browser control from loading after setting the "url" property 
to empty 

Fix bug that caused url progress messages to be sent when setting the htmltext of 
the browser on Windows & Linux 

Fix bug that caused url progress messages to be sent when setting the htmltext of 
the browser on Windows & Linux 

Fix a crash when pressing "Next" on the virtual keyboard while editing android native 
field contents 


22688 
22693 
22693 


22700 


Specific extension bug fixes (9.6.0-dp-4) 


22543 Fix display of "file://" urls for documents within an iOS app's private folder 
Fix bug preventing javascript being run from LiveCode script in the Android browser 


22668 widget 


Specific extension bug fixes (9.6.0-dp-3) 


22509 Ensure null mELLipsisLength does not cause widget to crash 


Specific extension bug fixes (9.6.0-dp-2) 


21719 Allowsetting fold state of selected element 
22241 Ensure getting the scrollingEnabled of the native android field does not throw an error 


22386 Save alternate row backgrounds property 
22387 Save showBorder property 
22498 Fixed a bug in the compilation of SVG 'rotate()' transforms 
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Camera Control Focus Mode 


The focusModes and focusMode properties can now be used with cameraControlGet and 
cameraControlSet on Android devices to list and choose from the modes available on the 
configured camera input device. 


17 


LiveCode 9.6.0 Release Notes 5/26/20 


The existing modes fixed, auto, and continuous together wth new modes autoSmooth, 
macro, macroSmooth, infinity, continuousSmooth, and extended are now supported on 
Android, and are described in the dictionary entries for cameraControlGet and 
cameraControlSet. 


The autoSmooth, macro, macroSmooth, and continuousSmooth focus modes are also now 
available on iOS. 


cameraControl no longer automatically configures the audio 
and video input devices when created. 


This allows the cameraControl to be configured for audio-only or video-only recording without 
unnecessary permission request dialogs being presented when the cameraControl is created. 


The "videoDevices", "audioDevices", "videoDevice", and "audioDevice" cameraControl properties 
have been made available on Android, allowing video and audio input devices to be configured 
independently. 


The "videoDevice" property accepts the values "default", "front", and "back" to specify the 
corresponding video input device, and the "audioDevice" property accepts the value "default" to 
specify the default audio input device. 


You can restore the previous behaviour by adding two more lines to your scripts to set both video 
and audio devices to their defaults: 


cameraControlCreate "myCamera" 
cameraControlSet "myCamera", "videoDevice", "default" 
cameraControlSet "myCamera", "“audioDevice", "default" 


Specific engine bug fixes (9.6.0-rc-2) 


22731 Fix Android cameraControl showing before being made visible 


Specific engine bug fixes (9.6.0-rc-1) 


22580 Fix crash recording from non-visible cameraControl on Windows 


Specific engine bug fixes (9.6.0-dp-3) 


Fix unusable files created by cameraControl when recording more than 10 seconds of 
audio on Mac 


22540 Improve quality of WMV video files recorded by cameraControl on Windows 


22409 


Specific engine bug fixes (9.6.0-dp-2) 
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18655 Fix handling of device orientation in iOS and Android camera controls 
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Android Barcode Scanner widget 


Android barcode scanner torchMode property 


A new property torchMode has been added to the Android barcode scanning widget. This 
property can be used to control when the device's flash light will turn on. The flash light can be 
used to improve scanning results in low light conditions. 


If set to of f, the flash light will never turn on. If set to on, the flash light will always be on. If set to 
auto, the flash light will turn on when the ambient light levels are deemed too low. 


Android barcode scanner isOperational property 


A new read only boolean isOperational property has been added to the Android barcode 
scanning widget. This property returns true if the widget is ready to scan barcodes. 


Additional libraries are required by the barcode scanning widget which are managed by Google 
Play Services and may be loaded or updated as required, meaning that barcode scanner may 
take some time to be operational. The isOperational property can be used to determine if the 
scanner is ready to detect barcodes. 


Android barcode scanner camera focus modes 


The Android barcode scanning widget has been updated to use the "auto" and "macro" focus 
modes of the device's camera. These modes will be used automatically when the device's camera 
does not support the continuous-video focus mode, improving scanning performance on older 
devices. 


Speech Library 


New library to synthesize speech 


A new macOS, iOS and Android library has been added that provides functionality for syntheisizing 
speech has been implemented. 


The library allows for choosing from among the system voices, altering the speech rate and pitch 
of the voice and speaking an utterance. 


See the dictionary for full details. 
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Specific extension bug fixes (9.6.0-rc-1) 


22315 Added torchMode property to Android barcode scanning widget 
22679 Add support for use of the Speech Library on Android 4.4 
22697 The snapshot of a scanned barcode is occasionally skewed 


The Android barcode scanning widget continues to scan when disabled but not when 


aeiee invisible 


Specific extension bug fixes (9.6.0-dp-4) 


22609 Barcode library and wdget fail to detect when the format is set to "QR Code" 
22637 Fix speechSetVoice failing to set the voice if it is previously set 
22666 Barcode scanning widget can occasionally crash when deleted 
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LiveCode Builder Language 


Objective-C block support 


The handler CreateObj cBlockPointerFromHandler has been added the objc module which 
facilitates the calling of Objective-C methods that require blocks. Objective-C blocks are objects 
defining fragments of code which can be called at a later date, typically used by methods that 
require progress callbacks or completion handlers. 


Create0bj cBLockPointerFromHandler wraps a LCB handler in an 0bj cBlockPointer and 
returns true on success and false otherwise. In order to call the 
CreateObj cBLockPointerFromHandler, pass the handler to be wrapped as the first argument 


and the variable into which the 0bj cBlockPointer should be placed as the second. 
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private variable sRequestPermissionsCompletionHandler as optional 
Obj cBlockPointer 
private variable sTarget as ScriptObject 


public handler AudioLibraryInitialize() returns Boolean 
Thaje apvoue 
Create0bj cBLockPointerFromHandler(RequestPermissionsCompletionHandler, \ 


sRequestPermissionsCompletionHandler) then 
put nothing into sRequestPermissionsCompletionHandler 
return false 
end if 
put the caller into sTarget 
Penetieley wel ule 
end handler 


public handler RequestPermissionsCompletionHandler(in pBlock as 
ObjcBlockPointer, in pGranted as CBool) 
post "AudioLibraryRequestPermissionsCallback" to sTarget with [pGranted] 


end handler 


In the example above, the handler RequestPermissionsCompletionHandLer is wrapped by the 
ObjcBlockPointer sRequestPermissionsCompletionHandler. 


The first parameter of the wrapped handler should be an 0bj cBlockPointer. The remaining 
parameters should match those of the Objective-C block the 0bj cBlLockPointer will be used 
with. 


Once created, an 0bjcBlockPointer can be used to call Objective-C methods that require 
blocks, passing the created 0bjcBlockPointer where an Objective-C block would be expected. 


private foreign handler ObjC AVCaptureDeviceRequestAccessForMediaType(in 
pMedialType as ObjcId, in pCompletionHandler as ObjcBlockPointer) \ 
returns nothing \ 
binds to 
"objc:AVCaptureDevice.+requestAccessForMedialype: completionHandler:" 


public handler AudioLibraryRequestPermissions() 
unsafe 


ObjC AVCaptureDeviceRequestAccessForMediaType(StringToNSString("soun"), 
sRequestPermissionsCompletionHand Ler) 

end unsafe 
end handler 


In the example above, the handler AudioLibraryRequestPermissions uses the previously 
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created block pointer, sRequestPermissionsCompLletionHandler, when calling the 
requestAccessForMedialype: completionHandler: method of the AVCaptureDevice type. 
The method expects the second argument, completionHandlLer: , to be a block that takes a 
single BOOL parameter, which in this case matched the signature of the handler 
RequestPermissionsCompletionHandlLer. 


The wrapped handler will be called whenever the block is invoked, with the first parameter being 
the O0bjcBlockPointer used to wrap the handler. 


In the above example, the RequestPermissionsCompLletionHandler handler will be called 
when the completionHandler: block is invoked, which in this case will be when the request 
permissions process has completed. 


The lifetime of a created 0bjcBlockPointer is not automatically managed. When such a value 
has no more references to it and it is no longer going to be used, DelLeteO0bj cBlockPointer 
Should be used to free the resources used by it. 


public handler AudioLibraryFinalize() 
if sRequestPermissionsCompletionHandler is not nothing then 
DeleteO0bj cBlockPointer(sRequestPermissionsCompletionHandler) 
put nothing into sRequestPermissionsCompletionHandler 
end if 
end handler 


LiveCode Builder Host Library 


Widget library 


The popup widget command now correctly positions the widget. 


Specific builder bug fixes (9.6.0-rc-1) 


22379 Fix error calling foreign handlers with non-default calling convention on 64-bit Windows 


Specific builder bug fixes (9.6.0-dp-3) 


19973 A null listener parameter no longer causes a crash. 


22603 The popup widget command incorrectly positions the popped up widget 


D) led (e)ar-lavar-releriarelals 
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e systemAppearance (property) has been added to the dictionary. 
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